home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / batch / bshell28 / bshell.doc next >
Text File  |  1991-03-16  |  10KB  |  177 lines
  1.                                 BSHELL V2.80
  2.                          Anderson & Zakas Consulting
  3.  
  4.  
  5.      BSHELL is a menuing system that catalogues, describes, and runs all your
  6.  executable files.  Though it is intended mainly for BATch files, it works
  7.  equally well with .COM and .EXE executable files.  It is quick, simple to use,
  8.  easy to learn, and requires no memory overhead since it is not a TSR.
  9.  
  10.      BSHELL sorts, catalogues, and runs all your batch (and executable) files.
  11.  
  12. ===============================BSHELL Features=================================
  13.  
  14.      -  54 Character descriptions describe each file catalogued
  15.      -  1 Key speed search
  16.      -  Searching for keywords in descriptions or file names
  17.      -  Stores 50 batch files (325 in registered version)
  18.      -  Configure to catalog and run any .BAT, .COM, or .EXE file
  19.      -  View or Edit batch files with your favorite editor
  20.      -  Mouse support 
  21.      -  Allows running batch files with the same name
  22.      -  Automatically scans hard drives for all your batch files
  23.      -  Run any batch file on any hard drive
  24.      -  Instant registration feature
  25.  
  26.  
  27. ================================Running BSHELL=================================
  28.  
  29.     Place BSHELL.EXE in the root directory or any directory on the PATH of your 
  30. hard disk.  Make this the current directory when running BSHELL for the first 
  31. time.  BSHELL will generate a data file called BSHELL.DAT the first time it is 
  32. run.   Both BSHELL.EXE and BSHELL.DAT should be kept in the same directory, one
  33. which is on the DOS PATH.   After this first execution of BSHELL, it can be
  34. called and executed from any subdirectory.  When run for the first time, BSHELL
  35. will automatically scan the current drive and search for all *.BAT files.  The
  36. initial description of all the batch files will be the file's respective PATHs.
  37.  
  38.     To execute a batch file stored in BSHELL,  use the PgUp, PgDn, Home, End,
  39. speed search, cursor keys, or mouse.  The file to be executed will be
  40. highlighted with a light bar.  Pressing ENTER or the left mouse button will
  41. execute the batch file.  Pressing ESC or the right mouse button will return
  42. you to DOS.
  43.  
  44.  
  45.                               ----KEYS----
  46.  
  47.   <ESC>      Pressing ESC from the main menu will exit the program and
  48.              put you back on the Drive and Directory you started from.
  49.              The highlighted batch file will not be run.
  50.  
  51. <ENTER>      Pressing ENTER will execute the highlighted batch file.
  52.  
  53.  0..9        The alpha numeric keys are used for speed searching.  Pressing a
  54.  A..Z        speed search key brings the highlight bar to the filename
  55.              whose first letter matches the key pressed.
  56.  
  57.   F1         Online help screen
  58.  
  59.   F2         A list of all hard drives in the system is displayed.  Using
  60.              the cursor keys or the mouse move the highlight bar to the drive
  61.              letter to be scanned.  Pressing ENTER or the left mouse button
  62.              will scan the selected drive for all files matching the *.BAT 
  63.              specification.  Pressing ESC or the right mouse button will abort 
  64.              this operation.  If the batch file found is already catalogued, it
  65.              will not be added to the database.  The files are sorted and then
  66.              displayed on the main screen.  This shareware version will show
  67.              the first 50 files catalogued.  The registered version of BSHELL
  68.              will store 325 files in the database.
  69.              
  70.   F3         Using the cursor keys or the mouse, move the highlight bar to the
  71.              entry to be edited and press F3 .  You will now be able to modify
  72.              the description for the current entry.  The description can be up
  73.              to 54 alph numeric characters long.  When you are done press ENTER
  74.              to store the changes or ESC to abort the changes and restore the
  75.              original description.
  76.  
  77.   F4         Press F4 to locate a string in the filename or description fields.
  78.              On top of the screen a prompt asking you to enter the search string
  79.              will appear .  Type in the string to search for and press ENTER.
  80.              The search is not case sensitive.  The highlight bar will be
  81.              positioned on the first occurance of a match.  If the string is
  82.              not found, an error message will be displayed.
  83.  
  84.   F5         Pressing F5 will search for the next occurance of the string
  85.              previously entered in F4. The highlight bar will be positioned on
  86.              the next match.  If the string is not found, an error message will
  87.              be displayed.
  88.  
  89.   F6         Pressing F6 will delete the highlighted record.  If the delete
  90.              confirmation is set to 'Y' (see F8),  you will be asked if you
  91.              want to delete this record.  Enter Y to delete or N to abort the
  92.              delete operation.
  93.  
  94.   F7         Pressing F7 will allow you to manually insert a record into the
  95.              database.  All fields must be completed.  
  96.                  The first field DRIVELETTER, is the letter of the hard drive
  97.              where the batch file is stored.  Valid letters are C through Z.
  98.                  The FILENAME field is the name of the batch file as it appears
  99.              on disk.  Format is filename.ext (ie  HELLO.BAT).
  100.                  The PATH field specifies the subdirectory that the batch file
  101.              is stored in.  The first and last characters entered in this field
  102.              should be \     If the batch file being entered is stored in a 
  103.              subdirectory called  C:\GAMES   then you would enter \GAMES\  in
  104.              this field.  A subdirectory called C:\LANG\PASCAL would be entered
  105.              \LANG\PASCAL\ 
  106.                  The last field is the DESCRIPTION field.  You may enter up to
  107.              54 alpha numeric characters to describe the batch file.
  108.  
  109.   F8          Pressing F8 allows you to configure some of the options of BSHELL.
  110.              The first field that is configurable is the FILES TO SCAN FOR
  111.              field.  BSHELL defaults to scanning for only batch files.  But by
  112.              using this option you can set BSHELL to scan for any executable
  113.              file.  If you set this field to  *.COM   the next time you use the
  114.              F2 option,  BSHELL will scan your hard drives for all COM files and
  115.              include them in the database.  All the options that are set to work
  116.              with batch files will now work with executable files.  This field
  117.              can also be set to *.EXE
  118.                The second field NAME OF FILE VIEWER allows you to specify the
  119.              program you will use to view or edit files.  The DEFAULT name if
  120.              Vern Buergs file viewer called LIST.COM.  You can use any editor
  121.              you may have, just type in the name.  Some editors that I have
  122.              tested are BROWSE.EXE, PCEDIT.EXE, NE.EXE, LIST.COM   After
  123.              configuring BSHELL to use your editor, place the editor in the same
  124.              subdirectory as BSHELL, or in any subdirectory on the DOS PATH.
  125.                The third field is the CONFIRM BEFORE DELETING field.  If you set
  126.              this field to Y, when pressing F6 from the main menu, you will be
  127.              asked if you are sure you want to delete the current record.
  128.              Setting this field to N will delete the record immediately when F6
  129.              is pressed, without asking for a confirmation.
  130.  
  131.   F9           Pressing F9 will allow you to enter your registartion password
  132.              which you will recieve when you register your copy of BSHELL
  133.              (see file BSHELL.REG)    Entering the password will remove the
  134.              registration screen and allow you to store up to 325 records in
  135.              BSHELL.  The pasword must be entered exactly as shown on the
  136.              registration confirmation letter you will recieve.
  137.  
  138.   F10           Pressing F10 will call your file editor or viewer so you can
  139.              view the file currently highlighted on the main screen.  Once you
  140.              are in the editor,  you may view or change the file.  After you
  141.              escape the editor, you will return to BSHELL.
  142.  
  143. ================================REGISTRATION===================================
  144.  
  145.      You may use BSHELL on a trial basis for up to 30 days freely.  You may give
  146.  it away to anyone you wish so long as you do not charge for it or use it as an
  147.  incentive to buy.  If, after the 30 day trial period, you wish to continue to
  148.  use BSHELL, a registration fee of $15 is required.  Please let me know what
  149.  version you currently have so that I can be sure to send you the correct
  150.  registration information.  Please the use registration form in the BSHELL.REG
  151.  file.
  152.  
  153.      Payment should be by check or money in U.S. funds drawn on a U.S. bank.
  154.  I can not be responsible for cash that is sent through the mail.  Printing the
  155.  file "BSHELL.REG" will produce an order form that you can use to register 
  156.  BSHELL.  Send your registration and/or inquiry to:
  157.  
  158.                                        Anderson & Zakas Consulting
  159.                                        119 Hubinger St.
  160.                                        New Haven  CT  06511
  161.  
  162.  
  163.  
  164.  
  165.  ====================================HINTS======================================
  166.  
  167.        Make the last line in all your batch files :
  168.  
  169.    BSHELL
  170.  
  171.    so BSHELL will be executed after your batch file ends.
  172.  
  173.  
  174.        Do not compress BSHELL with a utility such as PKLITE or LZEXE.  BSHELL
  175.    modifies itself to change configuration changes, and will be unable to do so
  176.    if it is compressed at run time.
  177.